home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / trim.z / trim
Encoding:
Text File  |  2002-10-03  |  1.9 KB  |  52 lines
  1. TRIM(3I)                                              Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      TTRRIIMM - Returns the character argument with trailing blank characters
  6.      removed
  7.  
  8. SSYYNNOOPPSSIISS
  9.      TTRRIIMM (([SSTTRRIINNGG==]_s_t_r_i_n_g))
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, IRIX systems
  13.  
  14.      CF90, MIPSpro 7 Fortran 90
  15.  
  16. SSTTAANNDDAARRDDSS
  17.      Fortran
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      The TTRRIIMM intrinsic function removes trailing blank characters from its
  21.      character argument.  If the input string contains trailing blank
  22.      characters, it returns the string without the trailing blanks.  If the
  23.      string contains only blanks, it returns a zero-length string.  It
  24.      accepts the following argument:
  25.  
  26.      _s_t_r_i_n_g    Must be of type character and be a scalar
  27.  
  28.      TTRRIIMM is a transformational function.  The name of this intrinsic
  29.      cannot be passed as an argument.
  30.  
  31. RREETTUURRNN VVAALLUUEESS
  32.      The result is a scalar entity of type character with a length that is
  33.      the length of _s_t_r_i_n_g without any trailing blank characters.  The value
  34.      of the result is the same as _s_t_r_i_n_g except that any trailing blanks
  35.      have been removed.  If _s_t_r_i_n_g contains only blank characters, the
  36.      result is a string of 0 length.
  37.  
  38. EEXXAAMMPPLLEESS
  39.      Consider the following example of a TTRRIIMM function reference.  In this
  40.      example, the carat (^^) represents a blank:
  41.  
  42.           CHVAR = TRIM( '^W^O^R^D^^' )
  43.           PRINT *,"CHVAR='",CHVAR,"'"
  44.  
  45.      This reference returns the following result:
  46.  
  47.           CHVAR='^W^O^R^D'
  48.  
  49. SSEEEE AALLSSOO
  50.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  51.      man page.
  52.